home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 9 / The Pier Shareware #9 (Pier Exchange).ISO / gap / gap_pro.txt < prev    next >
Encoding:
Text File  |  1996-03-03  |  10.7 KB  |  214 lines
  1.  
  2.     RoboSoft systems is pleased to offer several utilities for the GAP 
  3.     sysop in our GAP-Pro line of programs.  The GAP-Pro line currently 
  4.     consists of:
  5.  
  6.          GAP_LIST - The External File Lister for GAP
  7.          GAP_Verify - The External Filebase Verifier for GAP
  8.          Forum_Shuffle - The Forum Arranger for GAP
  9.          GAP_Merge - The Filebase Merger/Re-arranger for GAP
  10.  
  11.     Demos of all of the GAP-Pro utilities are available for download 
  12.     from The Cookie Jar at 714-997-0350.  See the enclosed GAP-PRO.REG
  13.     file for pricing and order information.
  14.  
  15.     Included with any order from the GAP-Pro utility line is a free 
  16.     copy of our NEWMSGS program.  NEWMSGS does essentially what the
  17.     GAP NEWMAIL utility does, update the counts of unread messages,
  18.     but does it in minutes instead of hours.
  19.  
  20.  
  21.     -------------------------------------------------------------------
  22.  
  23.  
  24.               GAP_LIST - The External File Lister for GAP          
  25.  
  26.     GAP_LIST is an external program used to generate file listings for 
  27.     GAP BBSs.  It will allow you to easily and quickly create file 
  28.     listings while you wait or in an event.
  29.     
  30.     Why do you need a program such as this when GAPFILE can already 
  31.     produce file listings?  Well, to start with, GAP_LIST was created 
  32.     with just one purpose in mind -- to create file lists.  It has been 
  33.     highly optimized for this specific mission.  GAP_LIST also 
  34.     generates all of the requested listings with just a single pass 
  35.     through the database.  What this adds up to is speed and 
  36.     flexibility. On my system I can generate condensed and enhanced 
  37.     listings for all areas AND for each subject in those areas, in well 
  38.     under half the time it takes to do just a condensed listing with 
  39.     GAPFILE.
  40.     
  41.     Here's a brief list of GAP_LIST's major features:
  42.     
  43.      - Creates Master lists of all areas and subjects specified in the 
  44.        configuration file.      
  45.      - Creates Area (Forum) lists including all subjects or individual 
  46.        subjects specified in the configuration file.    
  47.      - Creates individual listings for each area/subject.  (Registered 
  48.        version only)    
  49.      - Can create separate Condensed, Enhanced, Raw, and New (Registered 
  50.        version only) File listings in each of the categories above.    
  51.      - Creates a color summary bulletin listing the number of files and 
  52.        total bytes in each area and subject.    
  53.      - Allows files to be excluded from the listings according to 
  54.        security level.    
  55.      - Multi-user version can be run while users are still online.    
  56.      - Configuration file is plain ASCII so it's easy to change and you 
  57.        can have any number of different configurations.           
  58.     
  59.     GAP_LIST comes in two versions, one for single-node boards and one 
  60.     for multi-node boards.  (The multi-node version is available to 
  61.     registered users only.) You can use the single-node version on 
  62.     multi-node boards, but you must be sure that all nodes are inactive 
  63.     before running GAP_LIST. The multi-node version allows you to 
  64.     generate file listings while users are online and can be easily set 
  65.     up to run from an event.  (The multi-node version requires that you 
  66.     have a multi-node version of GAP.)
  67.     
  68.     
  69.     -------------------------------------------------------------------
  70.     
  71.     
  72.          GAP_Verify - The External Filebase Verifier for GAP
  73.            
  74.     
  75.     GAP_Verify is a batch mode maintenance tool for the GAP filebase.  
  76.     It's primary functions are:
  77.     
  78.       1.  Verify the size, date, and location of files in  the 
  79.           filebase.  
  80.       2.  Word-wrap the enhanced descriptions to fit the 72-character 
  81.           line allowed by GAP.  
  82.       3.  Extract and use FILE_ID.DIZ descriptions if found in .ZIP 
  83.           files.  
  84.       4.  Re-parse the keywords using a sysop-defined list of words 
  85.           to be excluded from use as indexed keywords.  
  86.       5.  Look for "lost" files on the hard drive.  These are files 
  87.           that exist on the hard drive but aren't in the GAP filebase.
  88.     
  89.     There are many options available to control exactly what gets done 
  90.     and how it is accomplished, but these are the base functions.
  91.     
  92.     To provide for extremely fast operation, GAP_Verify makes use of 
  93.     advanced virtual memory techniques.  If you have a couple megabytes 
  94.     of EMS/XMS memory available, GAP_Verify should just about fly on 
  95.     your machine.  The verify process should run anywhere from twice as 
  96.     fast to upwards of ten times as fast as the GAPFILE UPDATE 
  97.     function, depending on exactly what is being updated.
  98.     
  99.     GAP_Verify can word-wrap the enhanced descriptions to 72-character 
  100.     lines, optionally filtering out the high-ASCII characters often used 
  101.     to draw cute boxes around the descriptions.  
  102.     
  103.     You can have GAP_Verify look for a FILE_ID.DIZ in each .ZIP file it 
  104.     verifies.  If found, the DIZ description will be extracted and used 
  105.     to replace the current description.  Related to this function is the 
  106.     ability to specify a list of words which should not be indexed as 
  107.     keywords if found in the DIZ description.  This can cut down 
  108.     tremendously on the size of your FILEKEY files by eliminating 
  109.     nonsense keywords.
  110.     
  111.     GAP_Verify can re-parse the existing keywords using the keyword 
  112.     exclusion list mentioned above.  The parsing algorithm used by 
  113.     GAP_Verify is slightly different than that used by GAP itself and 
  114.     should result in a slight improvement in the resulting list of 
  115.     keywords.
  116.     
  117.     GAP_Verify can also print out a list of the files encountered in the 
  118.     directories it searched during the verification process that did not 
  119.     show up in the filebase.  If used correctly, this can help find a 
  120.     lot of dead wood on your hard drives (or locate files that fell 
  121.     into the cracks).
  122.     
  123.     One particularly handy use for GAP_Verify is to periodically scan 
  124.     your upload area and extract the FILE_ID.DIZ descriptions from the 
  125.     files uploaded in non-batch mode.  It will also update the file 
  126.     sizes to correct for comments added to the ZIP during UPCHECK 
  127.     processing.
  128.     
  129.     Because the whole idea behind GAP_Verify is speedy verification of 
  130.     your filebase, it allows a great degree of control over which files 
  131.     are verified and which directories are searched when looking for 
  132.     files.  You can tell GAP_Verify to ignore one or more partitions 
  133.     during its scan of the filebase.  Any files that reside on those 
  134.     partitions, according to the location in the filebase, will be 
  135.     completely skipped.  
  136.     
  137.     You can tell GAP_Verify to scan entire partitions, specific 
  138.     directories, or any combination of the two.  So if you want it to 
  139.     scan all of drive D:, but only a couple directories on drive E:, 
  140.     GAP_Verify can handle it.
  141.     
  142.     You can provide a list of specific files that should be skipped.  
  143.     This list gives you complete control over exactly which 
  144.     characteristic of the file (size, date, location, description, DIZ, 
  145.     keywords) should be skipped/ignored during the verification.  
  146.     Because this list might be rather lengthy, GAP_Verify can even 
  147.     generate one for you.
  148.     
  149.     If you use the parameter file method to tell GAP_Verify which 
  150.     partitions and/or directories to scan, it will automatically create 
  151.     a file containing the names of the directories it scanned.  If, on a 
  152.     later run, you haven't modified the parameter file, GAP_Verify will 
  153.     simply load the directory names from the file it previously created.  
  154.     If your directory structure changes infrequently, this technique can 
  155.     save quite a bit of startup time.
  156.     
  157.     GAP_Verify will automatically create a log file listing information 
  158.     about all the filebase entries it modified.
  159.     
  160.     All the GAP_Verify parameters can be specified on the command line.  
  161.     If you missed one or more required parameters, GAP_Verify will 
  162.     prompt you for those parameters.  Because there are so many control 
  163.     parameters whose command-line versions are a bit cryptic, you can 
  164.     set up an environment variable with a default set of parameters and 
  165.     specify overrides or additions, if necessary, on the command line.
  166.     
  167.     If you don't want to mess with the command line, just put GAP_Verify 
  168.     in your GAP default directory and run it.  It will prompt you for 
  169.     each required parameter and give you a complete explanation of what 
  170.     each is for.  There are a few of the "fine tuning" features of 
  171.     GAP_Verify that are only available from the command line, but 
  172.     you'll probably never miss them if you really don't want to mess 
  173.     with the command line.
  174.     
  175.     -------------------------------------------------------------------
  176.     
  177.              Forum_Shuffle - The Forum Arranger for GAP
  178.               
  179.     Forum_Shuffle will allow you to quickly and easily change the
  180.     arrangement of the forums on your GAP BBS.  It will do everything 
  181.     except update your menus.  All you have to do is figure out what 
  182.     order you want the forums in and Forum_Shuffle will do the rest, 
  183.     including rearranging all the files required for GAPQWK and 
  184.     MainMail.
  185.     
  186.     -------------------------------------------------------------------
  187.              
  188.              
  189.            GAP_Merge - The Filebase Merger/Re-arranger for GAP
  190.     
  191.     
  192.     GAP_Merge is a GAP filebase maintenance utility that will allow you 
  193.     to merge two GAP filebases together or to re-arrange the ordering of 
  194.     subjects in an existing GAP filebase.  The merge function is great 
  195.     when adding a CD-ROM, such as one of the Pier Exchange CDs, that 
  196.     comes with a GAP filebase.
  197.     
  198.     GAP_Merge will allow you to specify the mapping of subjects from 
  199.     source to destination filebase.  If you want files from Area 0, 
  200.     Subject 5 in the source to end up in Area 2, Subject 3 in the 
  201.     destination, GAP_Merge can handle it.  It will also do drive 
  202.     translations so you can map drive E: from the source filebase to 
  203.     drive X: in the destination filebase.
  204.     
  205.     If the destination filebase does not exist, GAP_Merge will create 
  206.     it.  This allows you to use the subject mapping capabilities to 
  207.     move your files around.
  208.     
  209.     GAP_Merge comes in single-node and multi-node versions.  The 
  210.     multi-node version allows you to merge filebases while users are 
  211.     still online.  (This isn't really recommended due to the heavy load 
  212.     the merge places on the system, but you can do it if you have to.)
  213.     
  214.